package com.example.service.service;

import com.example.service.entity.User;
import java.util.List;
import java.util.Optional;

/**
 * 用户服务接口
 * 定义用户相关的业务操作
 * 
 * @author example
 * @since 1.0.0
 */
public interface UserService {
    
    /**
     * 创建新用户
     * 
     * @param user 用户对象
     * @return 创建成功的用户对象
     * @throws IllegalArgumentException 如果用户名或邮箱已存在
     */
    User createUser(User user);
    
    /**
     * 根据ID查找用户
     * 
     * @param id 用户ID
     * @return 包含用户对象的Optional
     */
    Optional<User> findUserById(Long id);
    
    /**
     * 根据用户名查找用户
     * 
     * @param username 用户名
     * @return 包含用户对象的Optional
     */
    Optional<User> findUserByUsername(String username);
    
    /**
     * 根据邮箱查找用户
     * 
     * @param email 邮箱
     * @return 包含用户对象的Optional
     */
    Optional<User> findUserByEmail(String email);
    
    /**
     * 获取所有用户
     * 
     * @return 用户列表
     */
    List<User> findAllUsers();
    
    /**
     * 更新用户信息
     * 
     * @param user 用户对象
     * @return 更新后的用户对象
     * @throws IllegalArgumentException 如果用户不存在或用户名/邮箱已被其他用户使用
     */
    User updateUser(User user);
    
    /**
     * 删除用户
     * 
     * @param id 用户ID
     * @return 如果删除成功返回true，否则返回false
     */
    boolean deleteUser(Long id);
    
    /**
     * 检查用户名是否已存在
     * 
     * @param username 用户名
     * @return 如果存在返回true，否则返回false
     */
    boolean isUsernameExists(String username);
    
    /**
     * 检查邮箱是否已存在
     * 
     * @param email 邮箱
     * @return 如果存在返回true，否则返回false
     */
    boolean isEmailExists(String email);
} 